home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / comm1 / intsdkss.lha / password / password.doc next >
Text File  |  1996-04-09  |  2KB  |  85 lines
  1. TABLE OF CONTENTS
  2.  
  3. password/make_password
  4. password/pwd_algorithm_name
  5. password/make_password                                 password/make_password
  6.  
  7.    NAME
  8.     make_password -- create an encrypted password
  9.  
  10.    SYNOPSIS
  11.     ptr = make_password (buffer, password, username)
  12.     d0               a0    a1      a2
  13.  
  14.     STRPTR make_password (STRPTR buffer, const STRPTR password,
  15.                          const STRPTR username)
  16.  
  17.    FUNCTION
  18.     This function takes a pointer to a buffer, and pointer to a user
  19.     password as typed at a prompt (plaintext), and the username for
  20.     the user this password belongs to.  It will create an encrypted
  21.     password, placing it in the buffer provided.
  22.  
  23.     The encrypted password is usually stored in a file, for later
  24.     comparison, for authentication purposes.  For example, UNIX stores
  25.     the encrypted password in /etc/passwd along with other user info,
  26.     and I-Net 225 stores similar info in Inet:db/passwd.
  27.  
  28.    INPUTS
  29.     buffer        - pointer to a buffer of AT LEAST 32 bytes.
  30.     password    - pointer to the user's unencrypted password.
  31.     username    - pointer to the username.
  32.  
  33.    RESULT
  34.     ptr        - pointer to buffer on success, NULL on failure.
  35.  
  36.    EXAMPLE
  37.  
  38.    NOTES
  39.     The algorithm can be as simple or as complex as one wishes to
  40.     create.  If it will be used with I-Net 225, however, the generated
  41.     password must NOT be greater then 31 characters in length (the
  42.     32nd byte is forced to NUL, since it is treated as a string and
  43.     written to a text file), and it must NOT contain any non-printable
  44.     or control characters, or the vertical bar ('|') character.
  45.  
  46.     In most cases, this should properly be referred to as a HASH
  47.     function rather than an ENCRYPTION function, as it does a one-way
  48.     transformation of the data, and any method may be used.
  49.  
  50.    BUGS
  51.  
  52.    SEE ALSO
  53.     socket.library/s_crypt()
  54.  
  55. password/pwd_algorithm_name                       password/pwd_algorithm_name
  56.  
  57.    NAME
  58.     pwd_algorithm_name -- return the name of the implemented algorithm
  59.  
  60.    SYNOPSIS
  61.     name = pwd_algorithm_name ()
  62.  
  63.     char *pwd_algorithm_name (void);
  64.  
  65.    FUNCTION
  66.     This function is provided simply as a means to tell what hashing
  67.     or encrytion algorithm is used in the particular library.  It
  68.     returns a pointer to a string, usually a constant inside the
  69.     .library file.
  70.  
  71.    INPUTS
  72.     None
  73.  
  74.    RESULT
  75.     name        - a pointer to the algorithm name.
  76.  
  77.    EXAMPLE
  78.  
  79.    NOTES
  80.  
  81.    BUGS
  82.  
  83.    SEE ALSO
  84.  
  85.